<!DOCTYPE html>
<!-- Generated by pkgdown: do not edit by hand --><html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="utf-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><title>What percentage of this demographic group's population lives less than X miles from a site? — *** DRAFT - NEED TO RECHECK CALCULATIONS — plot_distance_by_pctd • EJAM</title><!-- favicons --><link rel="icon" type="image/png" sizes="16x16" href="../favicon-16x16.png"><link rel="icon" type="image/png" sizes="32x32" href="../favicon-32x32.png"><link rel="apple-touch-icon" type="image/png" sizes="180x180" href="../apple-touch-icon.png"><link rel="apple-touch-icon" type="image/png" sizes="120x120" href="../apple-touch-icon-120x120.png"><link rel="apple-touch-icon" type="image/png" sizes="76x76" href="../apple-touch-icon-76x76.png"><link rel="apple-touch-icon" type="image/png" sizes="60x60" href="../apple-touch-icon-60x60.png"><script src="../deps/jquery-3.6.0/jquery-3.6.0.min.js"></script><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><link href="../deps/bootstrap-5.3.1/bootstrap.min.css" rel="stylesheet"><script src="../deps/bootstrap-5.3.1/bootstrap.bundle.min.js"></script><link href="../deps/font-awesome-6.4.2/css/all.min.css" rel="stylesheet"><link href="../deps/font-awesome-6.4.2/css/v4-shims.min.css" rel="stylesheet"><script src="../deps/headroom-0.11.0/headroom.min.js"></script><script src="../deps/headroom-0.11.0/jQuery.headroom.min.js"></script><script src="../deps/bootstrap-toc-1.0.1/bootstrap-toc.min.js"></script><script src="../deps/clipboard.js-2.0.11/clipboard.min.js"></script><script src="../deps/search-1.0.0/autocomplete.jquery.min.js"></script><script src="../deps/search-1.0.0/fuse.min.js"></script><script src="../deps/search-1.0.0/mark.min.js"></script><!-- pkgdown --><script src="../pkgdown.js"></script><meta property="og:title" content="What percentage of this demographic group's population lives less than X miles from a site? — *** DRAFT - NEED TO RECHECK CALCULATIONS — plot_distance_by_pctd"><meta name="description" content="*** DRAFT - NEED TO RECHECK CALCULATIONS
This plots the cumulative share of residents found within each distance,
for a single demographic group."><meta property="og:description" content="*** DRAFT - NEED TO RECHECK CALCULATIONS
This plots the cumulative share of residents found within each distance,
for a single demographic group."><meta property="og:image" content="https://usepa.github.io/EJAM/logo.svg"></head><body>
    <a href="#main" class="visually-hidden-focusable">Skip to contents</a>


    <nav class="navbar navbar-expand-lg fixed-top bg-light" data-bs-theme="light" aria-label="Site navigation"><div class="container">

    <a class="navbar-brand me-2" href="../index.html">EJAM</a>

    <small class="nav-text text-warning me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">2.32.0</small>


    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>

    <div id="navbar" class="collapse navbar-collapse ms-3">
      <ul class="navbar-nav me-auto"><li class="active nav-item"><a class="nav-link" href="../reference/index.html">Reference</a></li>
<li class="nav-item dropdown">
  <button class="nav-link dropdown-toggle" type="button" id="dropdown-articles" data-bs-toggle="dropdown" aria-expanded="false" aria-haspopup="true">Articles</button>
  <ul class="dropdown-menu" aria-labelledby="dropdown-articles"><li><hr class="dropdown-divider"></li>
    <li><h6 class="dropdown-header" data-toc-skip>Overview for EJAM Users</h6></li>
    <li><a class="dropdown-item" href="../articles/0_whatis.html">What is EJAM</a></li>
    <li><a class="dropdown-item" href="../articles/0_webapp.html">Using EJAM</a></li>
    <li><hr class="dropdown-divider"></li>
    <li><h6 class="dropdown-header" data-toc-skip>For analysts using R</h6></li>
    <li><a class="dropdown-item" href="../articles/1_installing.html">Installing the EJAM R package</a></li>
    <li><a class="dropdown-item" href="../articles/2_quickstart.html">Quick Start Guide</a></li>
    <li><a class="dropdown-item" href="../articles/3_analyzing.html">Basics of Using EJAM for Analysis in RStudio</a></li>
    <li><a class="dropdown-item" href="../articles/4_advanced.html">Advanced Features</a></li>
  </ul></li>
<li class="nav-item"><a class="nav-link" href="../news/index.html">Changelog</a></li>
      </ul><ul class="navbar-nav"><li class="nav-item"><form class="form-inline" role="search">
 <input class="form-control" type="search" name="search-input" id="search-input" autocomplete="off" aria-label="Search site" placeholder="Search for" data-search-index="../search.json"></form></li>
<li class="nav-item"><a class="external-link nav-link" href="https://github.com/USEPA/EJAM/" aria-label="GitHub"><span class="fa fab fa-github fa-lg"></span></a></li>
      </ul></div>


  </div>
</nav><div class="container template-reference-topic">
<div class="row">
  <main id="main" class="col-md-9"><div class="page-header">
      <img src="../logo.svg" class="logo" alt=""><h1>What percentage of this demographic group's population lives less than X miles from a site? — *** DRAFT - NEED TO RECHECK CALCULATIONS</h1>
      <small class="dont-index">Source: <a href="https://github.com/USEPA/EJAM/blob/HEAD/R/plot_distance_by_pctd.R" class="external-link"><code>R/plot_distance_by_pctd.R</code></a></small>
      <div class="d-none name"><code>plot_distance_by_pctd.Rd</code></div>
    </div>

    <div class="ref-description section level2">
    <p>*** DRAFT - NEED TO RECHECK CALCULATIONS
This plots the cumulative share of residents found within each distance,
for a single demographic group.</p>
    </div>

    <div class="section level2">
    <h2 id="ref-usage">Usage<a class="anchor" aria-label="anchor" href="#ref-usage"></a></h2>
    <div class="sourceCode"><pre class="sourceCode r"><code><span><span class="fu">plot_distance_by_pctd</span><span class="op">(</span></span>
<span>  s2b <span class="op">=</span> <span class="cn">NULL</span>,</span>
<span>  sitenumber <span class="op">=</span> <span class="fl">1</span>,</span>
<span>  score_colname <span class="op">=</span> <span class="va">names_these</span><span class="op">[</span><span class="fl">3</span><span class="op">]</span>,</span>
<span>  scorewts_colname <span class="op">=</span> <span class="st">"pop"</span>,</span>
<span>  score_label <span class="op">=</span> <span class="fu"><a href="fixcolnames.html">fixcolnames</a></span><span class="op">(</span><span class="va">score_colname</span>, <span class="st">"r"</span>, <span class="st">"shortlabel"</span><span class="op">)</span>,</span>
<span>  radius <span class="op">=</span> <span class="fl">30</span></span>
<span><span class="op">)</span></span></code></pre></div>
    </div>

    <div class="section level2">
    <h2 id="arguments">Arguments<a class="anchor" aria-label="anchor" href="#arguments"></a></h2>


<dl><dt id="arg-s-b">s2b<a class="anchor" aria-label="anchor" href="#arg-s-b"></a></dt>
<dd><p>output of <code><a href="getblocksnearby.html">getblocksnearby()</a></code>, or else can be
a table of points with lat,lon columns and 1 row per point.
If NULL (not provided as a parameter to the function),
will prompt for a file to upload and use, if interactive() is TRUE, or else
the function will just show an example using a random point.</p></dd>


<dt id="arg-sitenumber">sitenumber<a class="anchor" aria-label="anchor" href="#arg-sitenumber"></a></dt>
<dd><p>If used, one number that is the unique ID
(the row number of original list of points) to look at in s2b.
This should be the same as the value of s2b$ejam_uniq_id for
the site to be analyzed.
Will be able to omit or set to NULL to use overall aggregate of all sites.</p></dd>


<dt id="arg-score-colname">score_colname<a class="anchor" aria-label="anchor" href="#arg-score-colname"></a></dt>
<dd><p>colname in blockgroupstats for an indicator to be
aggregated across blocks and blockgroups as a weighted mean</p></dd>


<dt id="arg-scorewts-colname">scorewts_colname<a class="anchor" aria-label="anchor" href="#arg-scorewts-colname"></a></dt>
<dd><p>colname in blockgroupstats – like "pop" – for the weight
to use in aggregating the scores referred to by score_colname</p></dd>


<dt id="arg-score-label">score_label<a class="anchor" aria-label="anchor" href="#arg-score-label"></a></dt>
<dd><p>optional friendly label for the variable</p></dd>


<dt id="arg-radius">radius<a class="anchor" aria-label="anchor" href="#arg-radius"></a></dt>
<dd><p>optional radius to use as maximum analyzed or shown –
if s2b was provided, this caps what is used and only shorter radii get shown
(only relevant if s2b had radii larger than this radius parameter)
and if s2b is not provided, interactively RStudio user is prompted
to provide latlon file to analyze in getblocksnearby() and
radius is used in that.</p></dd>

</dl></div>
    <div class="section level2">
    <h2 id="value">Value<a class="anchor" aria-label="anchor" href="#value"></a></h2>
    <p>returns s2b but with more columns in it like wtdmean_within</p>
    </div>
    <div class="section level2">
    <h2 id="details">Details<a class="anchor" aria-label="anchor" href="#details"></a></h2>
    <p>Also see ejamit_compare_distances() for a plot  of several indicators at several distances!</p>
<p>This function uses the distance of each Census block from the site in conjunction with
the block group demographics, to provide a relatively detailed picture of
how far away residents in each group live. In contrast, the function
<code><a href="distance_cdf_by_group_plot.html">distance_cdf_by_group_plot()</a></code> is based on ejamit()$results_bybg_people,
which provides only block group resolution information about distance.</p>
    </div>

    <div class="section level2">
    <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-examples"></a></h2>

    </div>
  </main><aside class="col-md-3"><nav id="toc" aria-label="Table of contents"><h2>On this page</h2>
    </nav></aside></div>


    <footer><div class="pkgdown-footer-left">
  <p>US EPA 2024</p>
</div>

<div class="pkgdown-footer-right">
  <p>EJAM Version 2.32.0</p>
</div>

    </footer></div>





  </body></html>

